home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-11 / vs_804.zip / VERNSIX.DOC < prev    next >
Text File  |  1991-10-13  |  13KB  |  533 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.                               Vern Six's Clipper ToolBox
  16.  
  17.                                   for Clipper v5.0x
  18.  
  19.  
  20.  
  21.                           *********************************
  22.                           *** SHAREWARE EVALUATION COPY ***
  23.                           *********************************
  24.  
  25.  
  26.  
  27.                                    October 13, 1991
  28.  
  29.                                      Release 8.00
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.                       Copyright (c) 1991 by Vernon E.   Six, Jr.
  38.                             All Rights Reserved World Wide
  39.  
  40.  
  41.  
  42.  
  43.                         VERNSIX5.LIB is distributed through: 
  44.  
  45.                                   FrontLine Software
  46.                             2908 Forest Hollow Lane, #2329
  47.                                 Arlington, Texas 76006
  48.                                Ph: 214/283-3282 - Voice
  49.                                 Ph: 817/695-0058 - BBS
  50.  
  51.  
  52.                Vernon E. Six, Jr. may be contacted electronically via:
  53.  
  54.                                 CompuServe: 72240,3122
  55.                                 FidoNet: 1:124/4003.0
  56.                                 ClipMail: CLIPBRD_HOME
  57.  
  58.  
  59.  
  60.                                           1
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.                                   Table of contents
  69.                                   -----------------
  70.  
  71.           Licensing Terms and Conditions  . . . . . . . . . . . . . . .   3
  72.  
  73.           Disclaimer of Warranty  . . . . . . . . . . . . . . . . . . .   5
  74.  
  75.           How my programs are assigned version numbers  . . . . . . . .   6
  76.  
  77.           Syntax Conventions  . . . . . . . . . . . . . . . . . . . . .   9
  78.  
  79.           Variable naming conventions . . . . . . . . . . . . . . . . .   9
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.                                           2
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.                             Licensing Terms and Conditions
  128.                             ------------------------------
  129.  
  130.                      Copyright (c) 1988-91 by Vernon E. Six, Jr.
  131.                            All Rights Reserved World Wide.
  132.  
  133.           VernSix5.Lib  may  only    be  used  and  distributed  under  the
  134.           following conditions:
  135.  
  136.                1)   You may use VernSix5.Lib  for a period of up  to thirty
  137.                     days to determine its  suitability for your needs.   If
  138.                     you continue  to use VernSix5.Lib (or  any program with
  139.                     VernSix5.Lib linked  into it) after a  period of thirty
  140.                     days you MUST register your copy.
  141.  
  142.                     A  registration form  is  included in  the distribution
  143.                     files with the name of REGISTER.FRM.
  144.  
  145.                2)   When you  register your copy of  VernSix5.Lib, you will
  146.                     receive:
  147.  
  148.                     a)   the  latest  version  without the  "advertisemnet"
  149.                          screen
  150.  
  151.                     b)   a   royalty   free   run-time   license   to   use
  152.                          VernSix5.Lib in any of your applications.
  153.  
  154.                     c)   complete source code
  155.  
  156.                3)   You may distribute VernSix5.Lib provided that no fee is
  157.                     charged,  except  for  a   nominal  "diskette"  fee  or
  158.                     "connect  time" charges.  In any  event, the entire fee
  159.                     shall  not  exceed $10.00.    This  does  NOT apply  to
  160.                     commercial packages developed  using VernSix5.Lib  (see
  161.                     paragraphs 1 and 2).
  162.  
  163.                4)   You may  NOT use  VernSix5.Lib in conjunction  with any
  164.                     commercial endeavor without
  165.  
  166.                     a)   registering your copy, and
  167.  
  168.                     b)   seriously  considering  providing  a "blurb"  line
  169.                          about   theauthor  of  VernSix5.Lib    i.e.  "This
  170.                          application uses VernSix5.Lib.  Copyright (c) 1991
  171.                          by  Vernon   E.  Six,   Jr."  somewhere   in  your
  172.                          application's documentation.
  173.  
  174.                5)   You may NOT distribute VernSix5.Lib in modified form.
  175.  
  176.                6)   If  you  distribute VernSix5.Lib,  it  MUST  be in  the
  177.  
  178.                                           3
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.                     original "archive" as released  by the author.  You may
  187.                     not  add any  files, archive  comments,   nor may   you
  188.                     re-archive it  using some  other archive  program, etc.
  189.                     This is to ensure that my software hasn't been tampered
  190.                     with.
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.                                           4
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.                                 Disclaimer of Warranty
  246.                                 ----------------------
  247.  
  248.                                  *** NO WARRANTY ***
  249.  
  250.           Because  VernSix5.Lib is  distributed as  "SHAREWARE",  I provide
  251.           absolutely  no warranty,  to the  extent permitted  by applicable
  252.           state  law.
  253.  
  254.           Except when  otherwise stated  in  writing, Vernon  E. Six,  Jr.,
  255.           FrontLine Software and/or  other parties provide VernSix5.Lib "AS
  256.           IS" without  warranty of any  kind, either expressed  or implied,
  257.           including,  but  not  limited   to,  the  implied  warranties  of
  258.           merchantability and fitness for a particular purpose.  The entire
  259.           risk  as to the quality  and performance of  VernSix5.Lib is with
  260.           you.  Should VernSix5.Lib prove defective, you assume the cost of
  261.           all  necessary remedies, repair or correction.
  262.  
  263.           In no event  will Vernon E. Six, Jr. and/or FrontLine Software be
  264.           responsible in any way  for the behavior of modified  versions of
  265.           VernSix5.Lib.  In  no event, unless required  by applicable state
  266.           law, will Vernon  E. Six,  Jr., FrontLine Software  or any  other
  267.           party  who  may  distribute  VernSix5.Lib  as  permitted  in  the
  268.           licensing  agreement, be liable to you for damages, including any
  269.           lost  profits,  lost  monies,  or other  special,  incidental  or
  270.           consequental damages arising out  of the use or inability  to use
  271.           (including but  not limited to  loss of data or data being render
  272.           inaccurate or losses sustained  by third parties or a  failure of
  273.           the program to operate with any other program) VernSix5.Lib, even
  274.           if you have been advised of  the possibility of such damages,  or
  275.           any claim by any other party.
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.                                           5
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.                      How my programs are assigned version numbers
  305.                      --------------------------------------------
  306.  
  307.           With  any   programming  effort  there  are   several  phases  of
  308.           development.  The phases  that my products go through  are listed
  309.           below.
  310.  
  311.           Phase 1) Planning & Design
  312.  
  313.                This  is where  the product  is completely  laid out.   i.e.
  314.                Exactly  what do  we want  to accomplish with  this product?
  315.                What are the major steps  necessary to accomplish this? Data
  316.                normalization, etc.
  317.  
  318.           Phase 2) Detail definition
  319.  
  320.                During this  phase I  break the  total product  into several
  321.                much  smaller  pieces.    i.e.     What  are  the   database
  322.                structures? What will the screens look like? etc.
  323.  
  324.           Phase 3) Program Development
  325.  
  326.                This is  phase where  I try to  put several  of the  smaller
  327.                pieces together.  This is also known as the "Alpha" stage of
  328.                the product.  Several  test releases of the product  will be
  329.                made during  this time.   These  releases are  called "Alpha
  330.                releases".
  331.  
  332.                An  "Alpha" release  signifies that  new development  on the
  333.                product has taken  place.   i.e.  new  functions &  features
  334.                have been added since the last "Alpha" release.
  335.  
  336.           Phase 4) Debugging & Final Polishing
  337.  
  338.                This phase begins when  all the smaller pieces are  in place
  339.                and all "Alpha" releases have stopped.  This is known as the
  340.                "Beta"  stage of  the  product.    Several releases  of  the
  341.                product  will be made during this time.  Each release during
  342.                this phase is called a "Beta release".
  343.  
  344.                A "Beta" release signifies that a "bug" has  been eliminated
  345.                since the last "Beta" release.
  346.  
  347.           Phase 5) Documentation
  348.  
  349.                The user documentation is developed and written.
  350.  
  351.           Phase 6) Release to public
  352.  
  353.                Release to public  is the final  stage of the product.   The
  354.  
  355.                                           6
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.                product is thought to be "bug free".
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.                                           7
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.                              Version Numbering continued
  423.                              ---------------------------
  424.  
  425.           Examples....
  426.  
  427.           1.00.a1   First Alpha  release of  v1.00 (v1.00 will  be a  major
  428.                     release)
  429.  
  430.           1.00.a2   Second  Alpha   release  of  v1.00   (added  some  more
  431.                     features)
  432.  
  433.           1.00.a3   Third Alpha release of v1.00 (added some more features)
  434.  
  435.           1.00.b1   First  Beta  release   (stopped  adding  features,  now
  436.                     concentrating on finding bugs) e.g.  Entering phase 4
  437.  
  438.           1.00.b2   Second Beta release (fixed some bugs)
  439.  
  440.           1.00.b3   Third Beta release (fixed some more bugs)
  441.  
  442.           1.00      First Public  release  (a/k/a Major  Release) No  known
  443.                     bugs!
  444.  
  445.           1.01      Fixed  some minor bug(s) that were not detected in Beta
  446.                     Test stage (usually a spelling error, etc.)
  447.  
  448.           1.10      Fixed some major bug(s) that were not  detected in Beta
  449.                     Test stage  OR  added some  program functionality  that
  450.                     wasn't thought of at development time.
  451.  
  452.           2.00.a1   First Alpha release  of v2.00  (v2.00 will  be a  major
  453.                     release)  i.e. v2.00 starts back at phase 1 and is (for
  454.                     all pratical purposes) a new product.
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.                                           8
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.                                   Syntax Conventions
  482.                                   ------------------
  483.  
  484.           This documentation uses the following syntax conventions:
  485.  
  486.                ...       Ellipsis means something was omitted.
  487.  
  488.                < >       Metavariable: something you must furnish
  489.  
  490.                <exp?>    Expression of specific data-type  where ? equals C
  491.                          for character,  D for date,  N for numeric,  M for
  492.                          memo, L for logical or any type if omitted.
  493.  
  494.                <memvar>  Name of a memory variable
  495.  
  496.                []        Optional syntax.
  497.  
  498.                [...]     Option may be repeated zero or more times.
  499.  
  500.                |         A choice: ON | OFF, Numeric | Date, etc.
  501.  
  502.  
  503.                              Variable naming conventions
  504.                              ---------------------------
  505.  
  506.           The  following is a table of the variable naming conventions used
  507.           in all the examples and source code in my library.
  508.  
  509.                             Character  Numeric    Logical    Date
  510.                           +-------------------------------------------+
  511.           Local           | c_name     n_name     l_name     d_name   |
  512.           Parameter       | pc_name    pn_name    pl_name    pd_name  |
  513.           Local Array     | ac_name    an_name    al_name    ad_name  |
  514.           Parameter Array | pac_name   pan_name   pal_name   pad_name |
  515.                           +-------------------------------------------+
  516.  
  517.           Examples:
  518.  
  519.           c_LastName is a  name for  a character variable  contains a  last
  520.           name.
  521.  
  522.           n_Acct is a  name for  a numeric variable  containing an  account
  523.           number
  524.  
  525.           gc_Color is  a  name for  a  Global (PUBLIC)  character  variable
  526.           containing a color setting.
  527.  
  528.  
  529.  
  530.  
  531.  
  532.                                           9
  533.